package com.ruoyi.quanzi.mapper;

import java.util.List;
import com.ruoyi.quanzi.domain.SunTopicMember;
import org.apache.ibatis.annotations.Param;

/**
 * 话题成员数据层
 * 
 * @author ruoyi
 */
public interface SunTopicMemberMapper
{
    /**
     * 查询话题成员
     * 
     * @param id 话题成员ID
     * @return 话题成员
     */
    public SunTopicMember selectSunTopicMemberById(Long id);

    /**
     * 查询话题成员列表
     * 
     * @param sunTopicMember 话题成员
     * @return 话题成员集合
     */
    public List<SunTopicMember> selectSunTopicMemberList(SunTopicMember sunTopicMember);

    /**
     * 新增话题成员
     * 
     * @param sunTopicMember 话题成员
     * @return 结果
     */
    public int insertSunTopicMember(SunTopicMember sunTopicMember);

    /**
     * 修改话题成员
     * 
     * @param sunTopicMember 话题成员
     * @return 结果
     */
    public int updateSunTopicMember(SunTopicMember sunTopicMember);

    /**
     * 删除话题成员
     * 
     * @param id 话题成员ID
     * @return 结果
     */
    public int deleteSunTopicMemberById(Long id);

    /**
     * 批量删除话题成员
     * 
     * @param ids 需要删除的话题成员ID
     * @return 结果
     */
    public int deleteSunTopicMemberByIds(Long[] ids);
    
    /**
     * 根据话题ID和用户ID查询成员
     * 
     * @param topicId 话题ID
     * @param uid 用户ID
     * @return 话题成员
     */
    public SunTopicMember selectMemberByTopicAndUser(@Param("topicId") Long topicId, @Param("uid") Long uid);
    
    /**
     * 根据话题ID查询成员列表
     * 
     * @param topicId 话题ID
     * @param role 角色（可选）
     * @param status 状态（可选）
     * @return 成员集合
     */
    public List<SunTopicMember> selectTopicMembers(@Param("topicId") Long topicId, @Param("role") Integer role, @Param("status") Integer status);
    
    /**
     * 根据用户ID查询加入的话题列表
     * 
     * @param uid 用户ID
     * @param status 状态（可选）
     * @return 话题成员集合
     */
    public List<SunTopicMember> selectUserTopics(@Param("uid") Long uid, @Param("status") Integer status);
    
    /**
     * 统计话题成员数量
     * 
     * @param topicId 话题ID
     * @param status 状态（可选）
     * @return 成员数量
     */
    public int countTopicMembers(@Param("topicId") Long topicId, @Param("status") Integer status);
    
    /**
     * 统计用户加入的话题数量
     * 
     * @param uid 用户ID
     * @param status 状态（可选）
     * @return 话题数量
     */
    public int countUserTopics(@Param("uid") Long uid, @Param("status") Integer status);
    
    /**
     * 检查用户是否已加入话题
     * 
     * @param topicId 话题ID
     * @param uid 用户ID
     * @return 是否已加入
     */
    public boolean checkUserJoined(@Param("topicId") Long topicId, @Param("uid") Long uid);
    
    /**
     * 根据话题ID查询管理员列表
     * 
     * @param topicId 话题ID
     * @return 管理员集合
     */
    public List<SunTopicMember> selectTopicAdmins(@Param("topicId") Long topicId);
    
    /**
     * 查询话题活跃成员
     * 
     * @param topicId 话题ID
     * @param limit 限制数量（可选）
     * @return 活跃成员集合
     */
    public List<SunTopicMember> selectActiveMembers(@Param("topicId") Long topicId, @Param("limit") Integer limit);
    
    /**
     * 根据话题ID和用户ID删除成员
     * 
     * @param topicId 话题ID
     * @param uid 用户ID
     * @return 结果
     */
    public int deleteMemberByTopicAndUser(@Param("topicId") Long topicId, @Param("uid") Long uid);
    
    /**
     * 更新成员最后活跃时间
     * 
     * @param topicId 话题ID
     * @param uid 用户ID
     * @return 结果
     */
    public int updateMemberLastActiveTime(@Param("topicId") Long topicId, @Param("uid") Long uid);
    
    /**
     * 更新成员发帖数量
     * 
     * @param topicId 话题ID
     * @param uid 用户ID
     * @param postCount 发帖数量
     * @return 结果
     */
    public int updateMemberPostCount(@Param("topicId") Long topicId, @Param("uid") Long uid, @Param("postCount") Integer postCount);
    
    /**
     * 更新成员积分
     * 
     * @param topicId 话题ID
     * @param uid 用户ID
     * @param integral 积分
     * @return 结果
     */
    public int updateMemberIntegral(@Param("topicId") Long topicId, @Param("uid") Long uid, @Param("integral") Integer integral);
}